集成 Yandex 聚合

重要

请确保将您使用的 Yandex 聚合 适配器和 第三方聚合网络适配器 更新到最新版本。旧版本可能会导致适配器集成错误,从而导致您的广告无法投放。

Yandex 聚合 是一个使用机器学习算法从各种网络自动选择广告的平台,以最大限度地提高您的收入。所有设置都是即插即用的,这意味着无需单独调试每个网络。

如果您之前仅在一个 Yandex 网络中使用 Yandex Mobile Ads SDK,则无需更改代码中的任何内容即可切换到 Yandex 聚合。您只需在外部广告网络的网页界面中预先配置单元即可。

初步设置

要准备您的应用,请按照下一节中的步骤操作。

应用要求

  • 使用 Android Studio 2021 或更高版本。
  • 使用 Android Gradle 插件 7.3.1 或更高版本。
  • 确保您的应用的构建文件使用以下值:
    • minSdkVersion 21 或更高版本。
    • compileSdkVersion 31 或更高版本。
  • 要加载任何类型的广告,您需要 Android 4.1 或更高版本。
  • 仅针对采用 Android 5 或更高版本的设备选择视频广告。
  • 如果您在应用程序中使用 AppMetrica SDK,请确保已安装第 7 个主版本 (7.x.x).。

在您的 Yandex Advertising Network 账户中设置应用程序

以下是在 Yandex Advertising Network 中注册您的应用的方法:

  1. 在 Yandex Advertising Network 中 登录登录 您的账户。
  2. 在 Yandex Advertising Network 中 注册 您的应用。

集成

启用移动聚合有两种方法:

  • 统一构建(推荐):所有可用的适配器都会自动添加。
  • 单独添加适配器:Yandex SDK 是单独安装的,然后使用各自的包一一添加特定的适配器。

您可以使用 yandex-mobileads-mediation 通用聚合包自动启用所有可用适配器。

  1. 在 Yandex 合作伙伴界面中 设置聚合

  2. 将 YandexMobileAdsMediation 依赖项添加到应用模块中的 build.gradle 文件中:

    dependencies {
           ...
           implementation 'com.yandex.android:mobileads-mediation:7.7.0.0'
    }
    

    对于每个适配器,会自动选择最新的兼容版本。

  3. 将对 Java 8 的支持添加到应用模块中的 build.gradle 文件:

    android {
    
        compileOptions {
            sourceCompatibility JavaVersion.VERSION_1_8
            targetCompatibility JavaVersion.VERSION_1_8
        }
    }
    
  4. 将以下代码添加到应用模块中的 build.gradle 文件中:

    // IronSource
    maven {
           url 'https://android-sdk.is.com/'
    }
    
    // Pangle
    maven {
           url 'https://artifact.bytedance.com/repository/pangle'
    }
    
    // Tapjoy
    maven {
           url "https://sdk.tapjoy.com/"
    }
    
    // Mintegral
    maven {
           url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea"
    }
    
    // Chartboost
    maven {
           url "https://cboost.jfrog.io/artifactory/chartboost-ads/"
    }
    
    // AppNext
    maven {
           url "https://dl.appnext.com/"
    }
    
  5. 设置使用广告 ID 的权限(从版本 4.5.0 开始可选)。

    如何设置使用广告 ID 的权限

    广告 ID 是 Google Play 服务提供的唯一标识符,用于向选择个性化广告的用户展示广告。用户可以选择退出广告个性化设置或在设置中重置其 ID。在这种情况下,广告网络将无法使用该 ID 为用户选择相关广告。

    如果您的应用运行低于 4.5 的 Yandex Mobile Ads SDK 版本,请将 com.google.android.gms.permission.AD_ID 添加到 AndroidManifest.xml 文件中:

    <manifest>
        <application>
        <!-- For apps targeting Android 13 or higher & Yandex Mobile Ads SDK versions lower than 4.5.0 -->
            <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
        </application>
    </manifest>
    

    从版本 4.5.0 开始,Yandex Mobile Ads SDK 默认添加 com.google.android.gms.permission.AD_ID。因此,您不必在应用程序的主清单中指定它。该权限允许您使用广告 ID 从广告网络中选择更相关的广告。

    如果需要,您可以删除该权限。例如,如果政策不允许使用 ID 来选择广告,例如家庭政策。

    要防止将该权限添加到应用程序的主清单中,请将以下代码添加到 AndroidManifest.xml 中:

    <manifest>
        <application>
            <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
        </application>
    </manifest>
    

    重要

    缺乏此权限和对 ID 的访问权限可能会降低广告的相关性,从而降低您的收入。

  6. Google AdMob (ex. AdMob) 网络的其他设置。

    使用名为 com.google.android.gms.ads.APPLICATION_ID<meta-data> 标记将您的 Google AdMob (ex. AdMob) ID 添加到为应用创建的 AndroidManifest.xml 文件(以下是如何查找您的 AdMob ID)。

    <manifest>
        <application>
    <!--...-->
            <meta-data
                android:name="com.google.android.gms.ads.APPLICATION_ID"
                android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    <!--...-->
        </application>
    </manifest>
    

要添加单独的适配器,请按照以下说明启用 Yandex Ads SDK 和相关适配器:

  1. 在 Yandex 合作伙伴界面中 设置聚合

  2. 将 YandexMobileAds 依赖项添加到应用模块中的 build.gradle 文件中:

    dependencies {
       ...
       implementation 'com.yandex.android:mobileads:x.x.x' // 添加支持的版本
    
       // 添加对 Yandex 聚合适配器的依赖项。
    
    }
    
  3. 将对 Java 8 的支持添加到应用模块中的 build.gradle 文件:

    android {
    
        compileOptions {
            sourceCompatibility JavaVersion.VERSION_1_8
            targetCompatibility JavaVersion.VERSION_1_8
        }
    }
    
  4. 将以下代码添加到应用模块中的 build.gradle 文件中:

    // IronSource
    maven {
           url 'https://android-sdk.is.com/'
    }
    
    // Pangle
    maven {
           url 'https://artifact.bytedance.com/repository/pangle'
    }
    
    // Tapjoy
    maven {
           url "https://sdk.tapjoy.com/"
    }
    
    // Mintegral
    maven {
           url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea"
    }
    
    // Chartboost
    maven {
           url "https://cboost.jfrog.io/artifactory/chartboost-ads/"
    }
    
    // AppNext
    maven {
           url "https://dl.appnext.com/"
    }
    
  5. 设置使用广告 ID 的权限(适用于运行 4.5.0 以下 SDK 版本的应用)。

    如何设置使用广告 ID 的权限

    广告 ID 是 Google Play 服务提供的唯一标识符,用于向选择个性化广告的用户展示广告。用户可以选择退出广告个性化设置或在设置中重置其 ID。在这种情况下,广告网络将无法使用该 ID 为用户选择相关广告。

    如果您的应用运行低于 4.5 的 Yandex Mobile Ads SDK 版本,请将 com.google.android.gms.permission.AD_ID 添加到 AndroidManifest.xml 文件中:

    <manifest>
        <application>
        <!-- For apps targeting Android 13 or higher & Yandex Mobile Ads SDK versions lower than 4.5.0 -->
            <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
        </application>
    </manifest>
    

    从版本 4.5.0 开始,Yandex Mobile Ads SDK 默认添加 com.google.android.gms.permission.AD_ID。因此,您不必在应用程序的主清单中指定它。该权限允许您使用广告 ID 从广告网络中选择更相关的广告。

    如果需要,您可以删除该权限。例如,如果政策不允许使用 ID 来选择广告,例如家庭政策。

    要防止将该权限添加到应用程序的主清单中,请将以下代码添加到 AndroidManifest.xml 中:

    <manifest>
        <application>
            <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
        </application>
    </manifest>
    

    重要

    缺乏此权限和对 ID 的访问权限可能会降低广告的相关性,从而降低您的收入。

  6. 使用适当的包一一添加适用的 适配器